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INTRODUCTION 


This Manual describes the functions and operation of the Z89 Monitor Program, 
MTR-89, that is contained in a read-only memory (ROM) in your Z89. Some of 
the major features of MTR-89 are: 


Memory contents display and alteration. 
Program execution control. 
Floppy diskette boot-strap routine. 


In addition, MTR-89 can be instructed (by means of a flag byte maintained in 
read/write memory) to bypass some or all of its normal functions. In this manner, 
a sophisticated user can augment or replace these functions. 
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THEORY OF OPERATION 


This section supplements the information in the “Operations” and ‘‘Circuit 
Description” sections of your Z89 Operations Manual. In order to use all of the 
features of MTR-89, itis necessary to understand the Z80 operation codes and the 
circuit of your Z89. This section gives you details of the operation of MTR-89. 
The listing of MTR-89 is given in Appendix A. 


Power Up and Reset 


MTR-89 initializes the Z89 whenever you power-up or RESET. To power-up, use 
the switch on the back of the Z89. To RESET, simultaneously press the RESET 
key and the right-hand SHIFT key on the keyboard. MTR-89 sounds the elec- 
tronic “bell” and resets to its normal state. During the initialization procedure, 
MTR-89 determines the high limit of continuous RAM in your Z89. Once this 
high limit has been determined, the Z80’s stack pointer is set to this value. Then 
MTR-89 enters a loop waiting for you to enter a command. 


Clock Interrupts 


The Clock Interrupt is a crucial element in the operation of the Z89. It is a level 
one interrupt and is generated on the Z89 CPU board every 2 ms (millisecond). 
MTR-89 maintains ‘““TICCNT” which counts up one every 2 ms. See the listing in 
Appendix A for the location of TICCNT. 


Note that MTR-89 uses interrupts, so you should not disable interrupts for a long 
period of time. MTR-89 also requires a stack pointer at the top of memory with at 
least 80 bytes. 


a Nw. 








a 


General Operations 


When you RESET or power-up your Z89, MTR-89 responds by clearing the 
screen and displaying “H:”. This tells you that it is ready to respond to your 
typed commands. When you type in something, MTR-89 will either accept it or 
give a beep, indicating an error. 


If the letter you enter is the first letter of one of MTR-89’s commands, it will 
display the remaining letters of the word. If the letter is not the start of a 
command, MTR-89 will sound the “bell’’ and ignore the letter. 


The DELETE key will kill a partially entered line and cause MTR-89 to return to 
the “H:” prompt. You can use this to correct typing errors. 


NOTE: In this manual, the symbol ‘‘a” means type a space and ‘‘@”’ means typea 
RETURN. 


The following is a list of the acceptable MTR-89 commands. You type the first 
letter of the command, and MTR-89 will supply the remainder of the word. You 
have to press the RETURN key before MTR-89 will respond. 


TABLE OF MTR-89 COMMANDS 


Substitute — Display or alter memory. 
Go — Start a program 

Program Counter — Set an address in the PC 
Boot — Boot from a diskette 


These commands are described in the remainder of this Manual. 
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DISPLAYING AND ALTERING MEMORY 


One of the major features of MTR-89 is its ability to examine the contents of any 
Z89 memory location and to modify the contents of that location if it isin RAM. 


The Substitute command is used to display memory locations. After a memory 
location has been displayed, its value can be changed before you proceed to 
something else. There is an example showing the Substitute procedure at the end 
of the description. You may jump ahead to it at any time. 


To start the substitution process, first type ““S’’. MTR-89 will respond by com- 
pleting the word ‘Substitute’. You should then enter the address of the memory 
location you want to inspect, followed by a RETURN. This address must be given 
in split-octal. Refer to Appendix B for the definitions of octal and split-octal. 


MTR-89 will respond by re-displaying the address with leading zeros. Following 
the address, MTR-89 will display the contents of that memory location in octal. 


Once the value of the memory location has been displayed, you may change it. 
To change it, simply type in the new value (in octal). The new value will be 
inserted after you complete the next step. 


NOTE: MTR-89 will use the last three digits that you enter. That is, the entry 
12345” will be entered as “345”. You may use this to correct errors as entries are 
made. 


After you have inspected or changed the value of a memory location, you have 
three options. First, you can cause MTR-89 to advance to the next memory 
location and display it by pressing the Space Bar. Second, you can cause MTR-89 
to retrieve the previous memory location and display it by pressing the minus 
key, ‘‘—’’. Finally, you can cause MTR-89 to return to its initial ‘‘H:” by pressing 
the RETURN key. 





Monitor 


a The following example shows these features. To help you follow what you enter 
and what the computer responds, your entries and the computer’s responses are 
shown on different lines. If a new line is really used, the new line will start at the 
left of the page. Otherwise, the output is shown just down a line. 


EXAMPLE 


H: computer 
Ss you 
ubstitute computer 
2146 @ you 
f 902146 041 computer 
1 A you 
r 002147 011 computer 
AB you 
f 002150 040 computer 
~- you 
002147 011 computer 
® you 
H: computer 
iS) you 
ubstitute computer 
40100 @ you 
040100 xxx computer 
123 a you 
aa 040101 xxx computer 
- you 
040100 123 computer 
@ you 
H: computer 
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PROGRAM EXECUTION CONTROL 


MTR-89 allows you to start a program that you have loaded into memory. It also 
offers a form of breakpointing. 


The standard way of starting a program is to use the Go command. After you type 
in “‘G”, MTR-89 responds “‘o’’. You should then type in the address (in split 
octal) where you want execution of your program to start. For example, if you 
have loaded a program at 040100, you can start it with: 


H: Go 40100 @ 


MTR-89 allows another method of starting programs. MTR-89 maintains in its 
working memory a value for the Program Counter. If you enter ‘‘G’”’ and then a 
RETURN after MTR -89 prints ‘“‘o”, MTR-89 will use the value in the PC as the 
starting address of your program. 


To set the value in the Program Counter, you use the “P” command. After you 
enter “P’”’, MTR-89 will respond “rogram Counter” and you can then enter the 
value you want. For example: 


H: Program Counter 40100@ 
H: Go@® 


Your program will now be started at 40100. 


If you do not enter a value after ‘‘P”’, but simply press RETURN, then MTR-89 will 
display the current value of the PC on the next line. You can change the PC by 
typing in a new value or you can leave it un-altered by pressing RETURN. For 
example: 


H: Program Counter@ 
277377 40100@ 


(You type the second number.) 


When you are debugging an assembly language program, you can use MTR-89 to 
set breakpoints at various places in the program. To set a breakpoint, use the 
Substitute command and put an HLT (166 octal) instruction where you want 
your program to stop. 
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When your program reaches the breakpoint HLT instruction, it will return to 
MTR-89, display an “‘H’’, and then advance to a new line and display ‘‘H:”. You 
can now use any of the MTR-89 commands. 


To continue your program, you will first have to restore the byte in the location 
where you placed the breakpoint HLT. Since the computer had to execute the 
HLT instruction, the PC will point one beyond where you placed the HLT. To 
continue, you will have to decrease the PC value by one. 


Do this by entering the “P” command and a RETURN. When the current value of 
the PC is shown, subtract one from it, and enter this value as the new value for the 
PC. Remember that you have to subtract in octal, so ten minus one is seven! 


Alternatively, you can use the “Go” command to start the program from what- 
ever address you want, including from the place where you put the HLT. 


Note that if the program that you are debugging uses keyboard interrupts, 
MTR-89 and your program may “‘fight” for keyboard input! Your program will 
always see every character because it gets them by an interrupt. MTR-89 is 
continually testing if a character is available, and it will never see some of the 
characters that you enter. 
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ADVANCED CONTROL 


One of the advanced features of MTR-89 is its provisions allowing sophisticated 
users to augment or replace MTR-89’s functions. This is usually done in conjunc- 


tion with assembly language programs, although it is sometimes possible to use: 


these features in BASIC using the PEEK and POKE commands. 


The following discussion refers to symbols and locations in MTR-89. In order to 
make the most of this information, you should refer to the listing of MTR-89 that 
is in Appendix A. Note that at the end of the listing the definitions of RAM 
locations from 40.000 to 40.077 and 41.120 to 41.125 are given. Following these 
is a symbol reference table that will help you find where symbols are used in the 
program. 


The Tick Counter (TICCNT) 


MTR-89 maintains in memory a 16-bit (2 byte) tick counter named TICCNT. This 
counter is incremented when the clock interrupts occur. As long as interrupts are 
enabled, this will occur every 2 ms. You may set TICCNT to any value and 
change it as often as you like. The low-order byte of TICCNT is in location 40.033 
(8219 decimal) and the high-order byte is in 40.034. 


Using Interrupts 


All Z89 interrupts cause control to be transferred into the lowest 64 bytes of 
memory. Since MTR-89 occupies this area, it processes all interrupts first. 
Except for level zero interrupts (RESET function), you can supply a routine to 
process interrupts yourself. 


Control is passed out of MTR-89 through the UIVECs (user interrupt vector) that 
are located at 40.037 and following. Each vector is three bytes long, and contains 
a JMP instruction to an interrupt processing routine. MTR-89 calls or jumps to 
the appropriate UIVEC, and control is passed to the processing routine. The exit 
from an interrupt processing routine should be the return instruction, RET. 


oN 





Ne 
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1/O Interrupts 


Interrupts numbered 3 through 7 are I/O interrupts of devices that you connect to 
your Z89. MTR-89 does not process these interrupts, but simply passes them on 
to a program in RAM by jumping to the appropriate UIVEC. 


Zenith Data Systems software (except MTR-89) use interrupt 3 for input and 
output to and from the keyboard and screen. Additionally, interrupts 4 and 7 are 
reserved for certain applications. These programs set UIVEC themselves. If you 
want to use interrupts, your program has to place the appropriate jump in the 
appropriate UIVEC. 


Clock Interrupts 


The level one interrupt is generated by hardware in your Z89 every 2 ms. MTR-89 
always processes these interrupts, but you can force it to pass control to your 
routine once it is done. 


To do this, set the appropriate jump in the first UIVEC locations. Then set the 
UO.CLK bit (001) in .MFLAG (40.010). MTR-89 will then pass each clock inter- 
rupt to your routine when it finishes its own processing. 


Single Instructions and Breakpoint Interrupts 


Level two interrupts are generated by the single-instruction hardware contained 
in the Z89. When asingle-instruction interrupt occurs, MTR-89 processes it, and 
jumps to the location specified by the second UIVEC. 


If you have set up UIVEC for level two interrupts, you can use RST-2 as a 
breakpoint instruction. Control will be returned to the location specified by the 
second UIVEC. 
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FLOPPY BOOT 


MTR-89 contains the code necessary to boot-up an operating system from a 
floppy disk. Two forms of “Boot” let you select the device (5-1/4" or Z47) and 
drive number (0-2 or 0-3). “Boot Primary” refers to the device that you will use 
most often. ‘Boot Secondary” provides you with a convenient way to boot from 
your alternate device, if you have one. 


BOOT PRIMARY 
The primary boot device is selected by switch SW501 sections 4, 1, and 0 on the 


CPU Logic Circuit Board. This switch is preset for 5-1/4” primary device. You 
may change the switch sections to select Z47 primary device. 


H: Boot @ Enter “‘B”’ and “RETURN” 
H: Bootd @® 5-1/4” drive primary: 
Enter ‘“‘B”’ 


and d(drive) = 0, 1, or 2 
followed by “RETURN” 


OR 
Z47 primary: 
Enter “B” 


and d(drive) = 0,1, 2, or 3 
followed by “RETURN” 
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BOOT SECONDARY 
H:Boot SD @ Enter ‘“B”, “S”, and “RETURN” 
H:Boot SDad @ 5-1/4” secondary: 
Enter ‘“B” and ‘“S” 
and d(drive) = 0, 1, or 2 
followed by ‘‘RETURN” 
OR 
ZA47 secondary: 
Enter ““B” and “‘S” 
and d(drive) = 0, 1, 2, or 3 
followed by “RETURN” 
Use the “DELETE” key to abort the boot command and return to the monitor. 
ERRORS 
The console will display a “?” if any of the following conditions occur: 
1. The boot device does not respond within 15 seconds. 
2. The ‘‘DELETE” key is pressed. 


3. Switch SW501 section 2 is set to “0”. 


4. A disk error occurs. 
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SWITCH SW501 


The sections of SW501 (on the Z89 CPU logic circuit board) have been redefined 
as follows: 


SWITCH SECTION DESCRIPTION 
76543210 





KXXXXXXO0OO Port 174/177 
XXXXXX01 Port 174/177 


5-1/4” drive 
Z47 


XXXXOOXX Port 170/173 = unused 
XXXXO1XKX Port 170/173 = Z47 


KXXXOKXKXX Boot primary from port 174/177 
XXXi1XXXX Boot primary from port 170/173 


XXOXXXXX Memory test 
XX1XXXXX Normal 


XOXXKXXXX Baud = 9600 


OXXXXKXKKX Normal 


ee 


APPENDIX A 


MTR-89 LISTING 


This appendix contains a listing of MTR-89. It contains all the control for 
primitive keyboard input and screen output. MTR-89 needs RAM locations 
available in locations 40.000 to 40.077 and 41.120 to 41.125, and it also needs 80 
bytes of stack area in high memory. 


The first few pages of the listing show definitions that are used. The last portion 
of the listing contains references to the symbols that are used in MTR-89. Just 
before this cross reference listing is the definition of RAM locations in 40.000 
through 40.077. 


To allow compatibility with other hardware, the MTR-89 code is segmented 
throughout memory. The Memory Test entry point is 7.375 and the Floppy 
Speed Test (5-1/4” drive) entry point is 7.372. 
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APPENDIX B 


OCTAL DEFINITIONS 


Binary numbers are converted to octal format for display. The following table 
shows binary to octal conversion. 


BINARY NUMBER OCTAL DIGIT 


000 
001 
010 
011 
100 
101 
110 
111 


N Oo BP wWNHeR OO 


Each byte is displayed as two-and-one-half octal digits. The octal numbers lie in 
the range of 000 to 377 for binary numbers in the range 00000000 to 11111111, as 
shown below. 


00 000 000 
2 Least significant octal digit (0-7). 


Middle octal digit (0-7). 


Most significant octal digit (0-3). 








monitor | 


NOTE: As there are only eight bits in a byte, the most significant octal digit only 
represents two bits and is therefore displayed as 0 to 3. If the user should 
inadvertently enter the octal digits 4 to 7 into the most significant digit, the most 
significant bit is lost. Losing this bit converts 4 through 7 into-the digits 0 
through 3 respectively. 


Also note that 16-bit numbers, such as memory addresses and certain register 
contents, are displayed as two eight-bit numbers. Therefore, the representation 
of 16-bit numbers is made up of two groups of three octal numbers in the range of 
000 to 377. This representation of 16-bit binary numbers is known as offset octal 
or split-octal, and is used consistantly for displays of 16-bit numbers. 


Split-octal must not be confused with octal. For example: 


42 111111 11 111 111 A 16-bit binary number 
| | I [S pc? of 
3°07 ~=«7 3°67 ~=«7 Split-octal representation (377 377) 
111112 111.111 A 16-bit binary number 


Pal al 1s off 
Zo LOG? TT True Octal representation (177777) 


1 111 

ee ee 
I 
1 


The lower example shows true octal representation of a 16-bit binary number. 
True octal representation is never used in standard Zenith Data Systems 
software. Occassionally you will see split-octal numbers printed with a decimal 
point separating the upper and lower bytes. For example: 

377.377 


Hi Byte Lo Byte 


Note that 001.000 follows 000.377. 
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